home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / letemfly.lzh / LETEMFLY.DOC < prev    next >
Text File  |  1994-01-16  |  12KB  |  311 lines
  1.  
  2.                              Let 'em Fly!
  3.                              ------------
  4.  
  5.                      (Flying Dials and more ...)
  6.  
  7.                              Version 1.20
  8.                               April 1993
  9.  
  10.                      (c) 1991-93 by Oliver Scheel
  11.                         Freaky Deaky Software
  12.  
  13.                            (it's Freeware)
  14.  
  15.  
  16. 1. Introduction
  17. ===============
  18.  
  19.      With Let 'em Fly! in your AUTO-Folder, many normal GEM dialogs can
  20. use the shortcuts Let 'em Fly! offers. There are many more features:
  21.  
  22. - flying dials
  23.     Many GEM dialogs learn to fly. This means you can drag them around
  24.     by using the mouse.
  25.  
  26. - key dials
  27.     Many dialogs can be operated by using shortcuts. Let 'em Fly! scans 
  28.     the dialog for possible keys. For example, the button 'Cancel' may 
  29.     be activated by pressing [UNDO] and/or [ALT]+[C].
  30.  
  31. - new edit functions within editable fields
  32.     This includes clipboard support, a history and a special character box
  33.     to enter ASCII chars.
  34.  
  35. - new alert boxes with new icons
  36.     The alert boxes have also been modified to load new icons.
  37.  
  38. - grow and shrink boxes can be switched off
  39.     This speeds up  screen redraws.
  40.  
  41. - intuitive function, easily understood
  42.  
  43.  
  44.      Let 'em Fly! works on Atari ST/STe/TT/Falcon computers in all 
  45. resolutions, including True Color; MultiTOS is supported, too.
  46.  
  47.      Let 'em Fly! comes with no warranty. This means that the author will
  48. not be liable for any damage which may caused by using Let 'em Fly!.
  49.  
  50.      Let 'em Fly! is Freeware; it may be freely used and distributed for
  51. noncommercial use. All rights are reserved by the  author!
  52.  
  53.      The Let 'em Fly! distribution package (English version):
  54.  
  55.      - LETEMFLY.PRG           the program itself
  56.      - LET_CONF.PRG/ACC       the configuration program
  57.      - LET_CONF.CPX           the same thing as a CPX module
  58.  
  59.      - GEM1ICON.RSC           the original Atari icons
  60.      - GEM2ICON.RSC           the GEM/2 icons
  61.      - LTMFICON.RSC           the Let 'em Fly! icons
  62.  
  63.      - LETEMFLY.TXT           this manual
  64.  
  65.  
  66.  
  67. 2. Installation
  68. ===============
  69.  
  70.      Copy the program LETEMFLY.PRG into your AUTO-Folder and restart
  71. the computer. To configure Let 'em Fly! use the accessory LET_CONF.ACC
  72. or the CPX LET_CONF.CPX.  The ACC also  runs as a program by renaming it
  73. LET_CONF.APP or .PRG. The switches are described later on.
  74.  
  75.  
  76. 3. Usage
  77. ========
  78.  
  79.      Let 'em Fly! requires programs use the right AES calls to handle
  80. dialogs; otherwise Let 'em Fly! can't act as wanted.
  81.  
  82. 3.1 Flying Dials
  83. ----------------
  84.  
  85. Within a GEM dialog there are selectable and nonselectable objects. If 
  86. you click a non selectable object the mouse arrow changes into a hand 
  87. and you can drag the dialog around by moving the mouse. By holding the 
  88. [SHIFT] key or the right mouse button, the dialog gets transparent and 
  89. you can look through it if it's hiding some important information.
  90.  
  91. 3.2 Key Dials
  92. -------------
  93.  
  94. Let 'em Fly! scans the current dialog for possible shortcuts and marks 
  95. them by drawing a line under the corresponding letter. You can activate 
  96. the button by holding the [ALT] key and pressing the letter or number. 
  97. If there is no editable field you don't need to press the [ALT] key. The
  98. function keys [UNDO] and [HELP] are supported, too. Let 'em Fly! scans
  99. the following strings to define these f-keys:
  100.  
  101. [UNDO]: 'abbruch', 'abbrechen', 'verlassen', 'ende', 'nein', 'quit', 
  102.         'cancel', 'abort', 'no', 'exit'
  103.  
  104. [HELP]: 'help', 'hilfe'
  105.  
  106. The UNDO button and the default button can be normally activated via the 
  107. first letter (e.g. 'Cancel' via [ALT]+[C]). Furthermore it's possible to 
  108. 'move' the default button around by pressing [ALT]+[Tab] or 
  109. [ALT]+[SHIFT]+[Tab] (backwards). [SHIFT]+[Help] displays a copyright 
  110. information including the current version number.
  111.  
  112. 3.3 Extended Editor
  113. -------------------
  114.  
  115. Within editbalbe fields, there are more functions when using Let 'em Fly!. 
  116. GEM supports the following functions:
  117.  
  118. [Cursor Up]         one field back
  119. [Cursor Down]       one field forward
  120. [Cursor Left]       one character left
  121. [Cursor Right]      one character right
  122. [TAB]               one field forward
  123. [RETURN]            terminate (apply) the dialog
  124.  
  125. But Let 'em Fly! gives you many many more functions ...
  126.  
  127. [RETURN]            if there is no default button, jump to the next 
  128.                     editable field
  129. [SHIFT]+[RETURN]    jump to the next editable field, even if there is a 
  130.                     default button
  131. [SHIFT]+[TAB]       one field back
  132. [SHIFT]+[Crsr Left]  jump to the beginning of the field
  133. [SHIFT]+[Crsr Right] jump to the end of the field
  134. [CTRL]+[Crsr Left]   jump one word left
  135. [CTRL]+[Crsr Right]  jump one word right
  136. [Home]              jump to the first editable field
  137. [SHIFT]+[Home]      jump to the last editable field
  138. [CTRL]+[Delete]     delete all characters to right of the cursor
  139.  
  140. Furthermore the keys [Crsr Up] and [Crsr Down] include a wrap-around 
  141. feature.  If you are within the first field and press [Crsr Up], the
  142. cursor jumps to the last field and the other way around. At least you
  143. can place the cursor directly using the mouse.
  144.  
  145. legal filename letters
  146. ----------------------
  147.  
  148. When an editable field uses a template for filename characters, normally 
  149. you can enter characters which are not allowed in filenames. Let 'em Fly! 
  150. fixes this bug, now.
  151.  
  152. special characters
  153. ------------------
  154.  
  155. There are some characters which are difficult to enter. If you press 
  156. [SHIFT]+[Insert] within an editable field a character box appears where 
  157. you can click the character you want. This function is only available, 
  158. when the template allows every character.
  159.  
  160. GEM-clipboard
  161. -------------
  162.  
  163. Let 'em Fly! supports the GEM-clipboard with the premise that the 
  164. environment variable CLIPBRD is set correctly (e.g. with SETCLIPB.CPX). 
  165. The following functions are supported now within editable fields:
  166.  
  167. [CTRL]-[X]     Copies the current line into the clipboard and deletes the 
  168.                field. If you press the [SHIFT]-key, too, the line will be 
  169.                appended to the content of the clipboard.
  170. [CTRL]-[C]     Copies the current line into the clipboard but doesn't 
  171.                delete the field. The [SHIFT]-key will react as described 
  172.                above.
  173. [CTRL]-[V]     Insert the first line of the clipboard into the current 
  174.                field. The previous content of the field will be deleted, 
  175.                but you can suppress this by pressing the [SHIFT]-key.
  176.  
  177. history (will teach us nothing...?)
  178. -----------------------------------
  179.  
  180. As in a commandline shell, Let 'em Fly! supports a small history (20 
  181. entries with each 40 characters) of the strings you typed before. Double 
  182. entries are suppressed automatically. With [CTRL]+[Crsr Up/Down] you can 
  183. scan the history and get back the previous typed strings. If you press 
  184. [SHIFT]+[Crsr Up/Down] the content of the field represents (the beginning 
  185. of) a string Let 'em Fly! searches the history for.
  186.  
  187.  
  188. 3.4 New Alert Boxes
  189. -------------------
  190.  
  191. Let 'em Fly! Alert Boxes will look a little bit differently from the
  192. originals. The size of the box is 'best-fitted' and there are new icons.
  193. The three buttons can be activated by pressing [F1]-[F3], too. To use
  194. another set of icons or a different color or shape, you can edit one of
  195. the icon resources (LTMFICON.RSC or GEM1/2ICON.RSC) with a RCS and copy
  196. it as LET_ICON.RSC into the AUTO folder.
  197.  
  198.  
  199. 3.5 Have a nice time with Niceline
  200. ----------------------------------
  201.  
  202. At the beginning, Niceline was a stand alone program. It replaces the 
  203. '---' strings in the menu by a 'nice line'. But I must add, that this is
  204. a small hack and doesn't always work with all programs (e.g. GFA basic).
  205. If there are any problems concerning menus, turn this feature off. 
  206.  
  207.  
  208. 4. The Configuration Program
  209. ============================
  210.  
  211. There are two programs to configure Let 'em Fly!: a normal program,
  212. LET_CONF.PRG/ACC, which can be installed as an accessory, too and a CPX 
  213. for the extendable contro